home *** CD-ROM | disk | FTP | other *** search
/ ftp.cs.arizona.edu / ftp.cs.arizona.edu.tar / ftp.cs.arizona.edu / icon / newsgrp / group93c.txt / 000031_icon-group-sender _Wed Aug 18 15:41:03 1993.msg < prev    next >
Internet Message Format  |  1994-02-02  |  5KB
  1. Received: from owl.CS.Arizona.EDU by cheltenham.CS.Arizona.EDU; Sun, 22 Aug 1993 14:42:32 MST
  2. Received: by owl.cs.arizona.edu; Sun, 22 Aug 1993 14:42:31 MST
  3. Date: 18 Aug 93 15:41:03 GMT
  4. From: pa.dec.com!open.ac.uk!Bugtales@decwrl.dec.com  (Marc Eisenstadt)
  5. Subject: 'MY HAIRIEST BUG' TALES: REPEATED REQUEST
  6. Message-Id: <9308181541.AA15611@watson.open.ac.uk>
  7. Sender: icon-group-request@cs.arizona.edu
  8. To: icon-group@cs.arizona.edu
  9. Status: R
  10. Errors-To: icon-group-errors@cs.arizona.edu
  11.  
  12. SUMMARY: Collecting debugging stories for analysis+archive. Please send yours!
  13.  
  14. We are collecting anecdotes describing memorable debugging experiences, with
  15. the aim of analysing them and building an archive to assist programmers in the
  16. future.  We will gratefully accept any stories describing very thorny software
  17. bugs, ideally (but not exclusively) involving large software projects and
  18. expert programmers.  A brief stream-of-consciousness reply right now would be
  19. much better than a detailed story that becomes too time-consuming for you to
  20. finish.  We can get back to you with further questions if necessary.  Thanks.
  21.  
  22. That's it! Next are OPTIONAL headings & FTP/email ways to access our study.
  23. ---------------------------------------------------------------------------
  24.  
  25. SUGGESTED OPTIONAL HEADINGS to facilitate later analysis & retrieval are
  26. supplied below. Please ignore these if they stifle your motivation, otherwise
  27. copy/paste :HEADING: labels into your reply. 1-liners (except STORY) are
  28. ideal.
  29.  
  30. :DISTRIBUTION: UNRESTRICTED | anyBBS | Internet-only | private 
  31. :ANONYMITY:    keep-author-anonymous | use-name-only | use-name-&-email
  32. :EXPERIENCE:   e.g. (at time of incident) 7 years industrial C programmer 
  33. :HARDWARE:     e.g. 486
  34. :OS:           e.g. DOS 5 + Windows 3.1
  35. :LANGUAGE:     e.g. M'Soft Visual C++
  36. :LIBRARIES:    e.g. Microsoft Foundation Class
  37. :TASK:         e.g. writing disk-cacheing software
  38. :SYMPTOM:      e.g. machine crashed after 40,000 iterations
  39. :HOW-NOTICED:  e.g. end-user reported it | obvious | Q.A. spotted it | etc.
  40. :WHY-HARD:     (one or more of...) intermittent | inconsistent | infrequent |
  41.                too-many-degrees-of-freedom | cause-far-from-effect | 
  42.                bug-consumed-evidence | Heisenbug-ran-OK-with-debugger | 
  43.                tedious-to-replicate | context-precluded-debugger-usage |    
  44.                unstructured-code | thought-<X>-was-<Y> | misdirected-blame | 
  45.                faulty-assumption | <other>
  46. :HOW-SOLVED:   (one or more of...) single-step | wrap-in-profiling-code |
  47.                print-statements | dump-data-study-diffs | conditional-breaks |
  48.                special-tool | gestation-meditation | explain-to-friend | 
  49.                expert-advice | controlled-experiment | <other>
  50. :ROOT-CAUSE:   (one or more of...) memory-clobbered | fault-of-vendor |
  51.                faulty-design-logic | bad-init-or-type-decl | wrong-var-or-op |
  52.                lexical-or-parsing-or-typo | language-semantics-misunderstood |
  53.                subtle-end-user-behavior | still-unsolved | <other> 
  54. :HEADLINE:     e.g. MSC disk-cache crash after 40K steps, array index err*
  55. :STORY:        <as lengthy as you have the patience to write!>
  56. :MORAL:        e.g. don't use pointers without comments 
  57.  
  58. *The :HEADLINE: is a one-line overview of the story which will be CRUCIAL
  59. for helping others pick it out from among thousands listed in a directory,
  60. and therefore should concisely convey the key gist of the story.  The
  61. categories for :WHY-HARD:, :HOW-SOLVED:, and :ROOT-CAUSE: have proved
  62. effective in the past, but they are just there to jog your memory. Your own
  63. words (or a combination of the suggested categories plus your own words)
  64. may be best.
  65.  
  66. DATA/ANALYSES/MOTIVATION VIA FTP OR EMAIL: 
  67. If you are interested in data from the previous 'trawls', or our conclusions 
  68. drawn from them, or a detailed discussion of the motivation for this study, 
  69. the relevant documents can be obtained by anonymous FTP from hcrl.open.ac.uk
  70. (in the directory /pub/bugtales).   We will also be setting up an email
  71. list-server facility to deal with correspondence.  In the meantime, comments,
  72. suggestions, and requests for emailed publications can be directed to 
  73. M.Eisenstadt@open.ac.uk.  Stories should be sent to Bugtales@open.ac.uk.
  74.  
  75. Incidentally, since we introduced the 'suggested headings' (e.g. :SYMTPOM:,
  76. :ROOT-CAUSE:, etc.) most of the respondents have in fact been using them, which
  77. is a great help to us.  Many thanks for your time and interest!
  78. Finally, thanks to Dan LaLiberte for suggesting the :HOW-NOTICED: category,
  79. and to Simon Masterton for assisting with data collection and analysis.
  80.  
  81. -Marc Eisenstadt (Personal email: M.Eisenstadt@open.ac.uk)
  82.  
  83.     _/    _/  _/_/_/_/  _/_/_/_/  _/    Human Cognition Research Lab
  84.    _/    _/  _/        _/    _/  _/     The Open University
  85.   _/_/_/_/  _/        _/_/_/_/  _/      Milton Keynes MK7 6AA, U.K.
  86.  _/    _/  _/        _/  _/    _/       Tel: +44 908 65-3800  Fax: -3169
  87. _/    _/  _/_/_/_/  _/    _/  _/_/_/_/  Internet: Bugtales@open.ac.uk
  88.